home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / diskutil / dskswich.lzh / DESKSWIT.TXT < prev   
Encoding:
Text File  |  1990-06-09  |  8.1 KB  |  182 lines
  1.  
  2.                            Desk Switch
  3.  
  4.                The Ultimate Read-Only Control Panel
  5.  
  6.                       By Charles F. Johnson
  7.           Copyright 1990 Little Green Footballs Software
  8.  
  9.                   Revised: Thursday, May 31, 1990
  10.  
  11.  
  12.                            Introduction
  13.                            ------------
  14.  
  15.      Desk Switch is a versatile and powerful little program, that lets
  16. you instantly switch from one desktop setup to another.  Desk Switch
  17. reads .INF files created with the GEM desktop's 'Save Desktop' function,
  18. and sets every parameter saved in the file.  It can be run as an
  19. ordinary program (by double-clicking from the desktop), or as an
  20. "Installed Application" from the desktop or from CodeHead Software's
  21. HotWire.
  22.  
  23.      The Atari Control Panel desk accessory is normally used to set most
  24. of the parameters in the DESKTOP.INF file, but it has some distinct
  25. disadvantages.  First, it gobbles up a fairly large chunk of memory. 
  26. Second, it doesn't allow you to load a new .INF file; after the initial
  27. bootup configuration, you must make all other adjustments individually,
  28. by hand. 
  29.  
  30.      There are many "read-only control panel" desk accessories available
  31. as shareware or public domain, which will install the parameters in the
  32. DESKTOP.INF file (just once, at bootup), but don't allow you to edit any
  33. of these parameters.  (Hence the term "read-only.")  The advantage that
  34. Desk Switch has over any other "read-only control panel" is that it
  35. performs these functions in less than 1K of code, does not stay resident
  36. in memory when its job is finished, and allows you to load and install a
  37. new .INF file at just about any time. 
  38.  
  39.      Here's a list of the parameters Desk Switch reads and sets from an
  40. .INF file:
  41.  
  42.      o The name and position of every desktop icon, including the drives
  43.        and the trash can.
  44.  
  45.      o The position and status (open or not) of all GEM desktop windows.
  46.  
  47.      o Screen colors.
  48.  
  49.      o Printer settings.
  50.  
  51.      o RS232 settings.
  52.  
  53.      o Blitter setting.  (If you have a blitter in your machine, that
  54.        is.)
  55.  
  56.      o Key repeat/delay settings.
  57.  
  58.      o Bell and keyclick on/off settings.
  59.  
  60.      o Mouse double-click response rate.
  61.  
  62.      o The list of installed applications contained in the .INF file.
  63.  
  64.  
  65.                   Copyright and Shareware Notice
  66.                   ------------------------------
  67.  
  68.      Desk Switch was originally published in ST-Log (under a "one time
  69. only" contract).  Since the issue that featured it is long out of print,
  70. and very difficult to find, I rewrote the documentation (and tweaked the
  71. code a bit) and decided to rerelease Desk Switch as a Little Green
  72. Footballs shareware product.
  73.  
  74.      "Shareware" means that this program may be freely distributed; but
  75. if, after trying it out, you end up using Desk Switch, you're expected
  76. to pay a small registration fee of $10.00.  If Desk Switch fills a need
  77. for you, send a check or money order for $10.00 to:
  78.  
  79.      Charles F. Johnson
  80.      P.O. Box 1250
  81.      Pacific Palisades, CA 90272
  82.  
  83. and please indicate on your check that this is a registration payment
  84. for Desk Switch -- this will enable me to enter your name properly in my
  85. shareware data base.  If you'd like me to acknowledge your payment,
  86. include a stamped, self-addressed envelope.  And if you also include a
  87. floppy disk, I'll fill it up with the very latest versions of all Little
  88. Green Footballs programs, and send it back to you. 
  89.  
  90.      Desk Switch is Copyright 1990 Charles F. Johnson and Little Green
  91. Footballs Software.  All Rights Reserved.  This program may be freely
  92. distributed, as long as both the program file and this documentation are
  93. included.  Neither file may be altered in any way whatsoever, and no
  94. part of this program or its accompanying documentation may be reprinted
  95. in any form without the express permission of the author.
  96.  
  97.  
  98.                    Preparing To Use Desk Switch
  99.                    ----------------------------
  100.  
  101.      First, you should boot up with the Atari Control Panel installed,
  102. to set up your desktop, screen colors, mouse/keyboard parameters, etc. 
  103. Then save the desktop, with the 'Save Desktop' selection in the
  104. 'Options' drop-down menu.  This will write a file to your boot drive
  105. called DESKTOP.INF; this file contains all the parameters used by the
  106. Control Panel and the desktop to configure your system. 
  107.  
  108.      After saving the desktop, rename the newly-written DESKTOP.INF file
  109. to something else (retaining the .INF extension).  Now you can repeat
  110. this procedure for as many color setups, disk icon arrangements,
  111. installed applications, etc.  as you wish, renaming the DESKTOP.INF each
  112. time after saving your desktop.  When you have several of these .INF
  113. files prepared, you may want to move them all into a folder of their own
  114. to keep things neat. 
  115.  
  116.      Desk Switch checks to make sure the file you're attempting to read
  117. is a valid .INF file, created with "Save Desktop."  If you tell Desk
  118. Switch to read something that is not an .INF file, you won't see any
  119. warning; the program will simply exit without doing anything.
  120.  
  121.  
  122.             Running Desk Switch Without a Command Line
  123.             ------------------------------------------
  124.  
  125.      If you run Desk Switch directly (by double-clicking it from the
  126. desktop or running it from CodeHead's HotWire), you will be presented
  127. with the GEM file selector.  Use the selector to locate and choose an
  128. .INF file to install, and then click the file selector's OK button.  The
  129. new desktop setup will be installed, and Desk Switch will immediately
  130. exit.
  131.  
  132.  
  133.            Using Desk Switch With "Install Application"
  134.            --------------------------------------------
  135.  
  136.      Desk Switch can also be run through the desktop's "Install
  137. Application" feature, by installing DESKSWIT.PRG as an application for
  138. .INF documents.  (See your ST User's Manual for more info about "Install
  139. Application".)  If you do this, you can install new desktop setups
  140. simply by double-clicking the .INF file you wish to install from the GEM
  141. desktop.
  142.  
  143.  
  144.                   Using Desk Switch With HotWire
  145.                   ------------------------------
  146.  
  147.      If you use CodeHead Software's HotWire, you can build an entire
  148. HotWire menu of .INF files to pass to Desk Switch, and instantly install
  149. any setup with a single click of the button, or a single keypress. 
  150. There are two ways you can do this:
  151.  
  152.      1) Click on any empty HotWire menu slot and locate DESKSWIT.PRG
  153.         with the file selector that appears.  In the Program Options box
  154.         that appears after you've chosen DESKSWIT.PRG, enter "INF" as
  155.         one of the "Documents" for DESKSWIT.PRG.  Now you can install
  156.         your .INF files as "documents" in the HotWire menu. 
  157.  
  158.      2) Click on a blank line and locate DESKSWIT.PRG (as above).  This
  159.         time, in the Program Options box, type in the name of the .INF
  160.         file you want to install in this slot as the title (yes, even
  161.         though we're actually going to be running Desk Switch), and
  162.         select the button labelled 'Command Line'.
  163.  
  164.         You should now have a slot in the HotWire menu with the title
  165.         you've chosen for the .INF file.  Click on that slot -- HotWire
  166.         will present you with its Command Line box.  On the command
  167.         line, enter the full path and name of the .INF file you wish to
  168.         use.  (HotWire's Command Line box also lets you use the file
  169.         selector to select the path and name, instead of typing it.)  As
  170.         the last thing in the line, type the '~' (tilde) character.
  171.         (You can get this character by holding either Shift key and
  172.         typing the key immediately to the left of the Backspace key on
  173.         the top row.)  The tilde is a special character which tells
  174.         HotWire not to pause and present the Command Line box when this
  175.         entry is run; instead HotWire will immediately run the program
  176.         and pass it the currently defined command line. 
  177.  
  178.      The advantage of running Desk Switch by the second method is that
  179. it can be chained to other programs this way.  (HotWire does not allow
  180. "documents" to be chained.)
  181.  
  182.